List enrolled Windows devices with filtering options.

GET

https://api.applivery.io/v1/organizations/{organizationId}/mdm/windows/enterprise/devices

curl -X GET "https://api.applivery.io/v1/organizations/{organizationId}/mdm/windows/enterprise/devices" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

const response = await fetch("https://api.applivery.io/v1/organizations/{organizationId}/mdm/windows/enterprise/devices", {
  method: "GET",
  headers: {
    Authorization: "Bearer <YOUR_API_KEY>",
  },
});

const data = await response.json();

import requests

response = requests.get(
    "https://api.applivery.io/v1/organizations/{organizationId}/mdm/windows/enterprise/devices",
    headers={"Authorization": "Bearer <YOUR_API_KEY>"},
)

data = response.json()

Request

Send your API key in the request header authorization

Example: Authorization: Bearer <token>

organizationId string

required

Match pattern: ^(([a-fA-F0-9]{24})|([a-zA-Z0-9\\-]{3,}))$

page integer

optional

Sequential page index for navigating large datasets, enabling systematic access to specific record subsets within the total collection.

limit integer

optional

Maximum number of records returned per request to control data density, optimize interface performance, and manage payload size

sort string

optional

Ordering criteria using a field-to-direction mapping to organize results based on specific attributes like creation date, name, or status.

Match pattern: ^[\w.]*((:asc)|(:desc))?$

mdm-user string

optional

Filter devices by assigned user identifier to retrieve only devices belonging to specific MDM users.

Match pattern: ^[a-fA-F0-9]{24}$

show-deleted boolean

optional

Include deleted devices in results when true, otherwise only active managed devices are returned.

tags array

optional

Filter devices by one or more organizational tags to narrow results to specific groups or categories.

segmentId integer

optional

Segment identifier for scoping device into an specific segment

expandTo string

optional

Param to include ancestor or child related entities

ancestorschildren

Responses

200 Response application/json

status boolean optional

data object optional

items array [object] optional

id string optional

Unique identifier for this specific resource instance in the system following a standardized format enabling targeted operations, relationship mapping, and tracking across all platform endpoints and data stores.

Match pattern: ^[a-fA-F0-9]{24}$

organizationId string optional

Organization identifier indicating workspace ownership for access control and data isolation across multi-tenant environments.

Match pattern: ^[a-fA-F0-9]{24}$

winEnterpriseId string optional

Windows enterprise configuration identifier linking device to specific enrollment settings and management policies.

Match pattern: ^[a-fA-F0-9]{24}$

mdmUser object optional

User account information for the individual assigned to this device, enabling user-based policy targeting and accountability.

displayName string optional

User-friendly device name displayed throughout interfaces for easy identification in device inventories and management workflows.

≤ 128 characters

tags array [string] optional

Organizational labels assigned for grouping, filtering, and automated policy targeting based on departments, locations, or functional roles.

winId string optional

Windows MDM system identifier assigned by Microsoft during device enrollment for communication with Windows management protocols.

≤ 128 characters

state string optional

Current enrollment lifecycle state tracking device management status for administrative workflows and compliance reporting.

PROVISIONING ACTIVE DELETED DELETE_REQUESTED UNKNOWN

config object optional

OMA-DM configuration object containing current device settings, security policies, and restrictions actively enforced on the device.

configDates object optional

Timestamp tracking object recording when specific configuration categories were last updated for change management.

customConfig object optional

Organization-specific configuration overrides and custom settings not part of standard policy definitions.

summary object optional

Device hardware and system information snapshot including OS version, battery status, and enrollment details.

scripts array [object] optional

Array of scripts assigned to this device enabling automated PowerShell or batch command operations.

scriptsInfo array [object] optional

Script metadata array containing execution history, results, and status information for assigned scripts.

lastStatusReportTime string optional

Timestamp of the most recent device status report received from the Windows MDM agent.

Format: date-time

type string optional

Device platform type designation indicating this is a Windows-managed endpoint.

≤ 128 characters

winPolicy object optional

Primary Windows policy object directly assigned to this device containing configurations and restrictions.

deviceWinPolicy object optional

Effective Windows policy applied to device after composition and conflict resolution across multiple assignments.

winPolicyAssignments array [object] optional

Array of Windows policy assignments applied to this device including priority ordering for conflict resolution.

winPolicyAssignmentsEnforced array [object] optional

Array of enforced Windows policy assignments including automation rule metadata documenting assignment sources.

subType string optional

Entity classification distinguishing enrolled devices from enrollment token placeholders in inventory queries.

≤ 128 characters

stateHistory array [object] optional

Historical state transitions tracking enrollment lifecycle changes and administrative actions over time.

lastLocation object optional

Most recent location information reported by the device agent or determined from IP address.

refreshInfoNeeded array [string] optional

Array of data categories requiring refresh from the device agent such as hardware, applications, or certificates.

enrolledDate string optional

Timestamp when this device completed initial enrollment and became managed, critical for tracking device age and lifecycle management.

Format: date-time

smartAttributeAssignments array [object] optional

smartAttributeAssignmentsEnforced array [object] optional

smartAttributes array [object] optional

segmentId integer optional

≥ 0

createdAt string optional

ISO 8601 timestamp indicating when this record was initially created in the database providing historical context, chronological ordering capabilities, and analytics for lifecycle tracking and reporting.

Format: date-time

updatedAt string optional

ISO 8601 timestamp indicating the last time this record was modified in the database useful for tracking changes, synchronization processes, and maintaining audit trails of all modifications.

Format: date-time

totalDocs integer optional

limit integer optional

hasPrevPage boolean optional

hasNextPage boolean optional

page integer optional

totalPages integer optional

prevPage integer optional

nextPage integer optional

lean boolean optional

{
    "status": true,
    "data": {
        "items": [
            {
                "id": "507f1f77bcf86cd799439011",
                "organizationId": "507f1f77bcf86cd799439022",
                "winEnterpriseId": "507f1f77bcf86cd799439033",
                "mdmUser": {
                    "id": "507f1f77bcf86cd799439066",
                    "email": "[email protected]"
                },
                "displayName": "Marketing Dept Laptop",
                "tags": [
                    "sales",
                    "field-team",
                    "remote"
                ],
                "winId": "device-win-mdm-12345678",
                "state": "ACTIVE",
                "config": {
                    "./Device/Vendor/MSFT/Policy/Config/Security/RequireDeviceEncryption": "1"
                },
                "configDates": {
                    "securityPolicy": "2026-02-10T10: 00: 00.000Z",
                    "applications": "2026-02-09T15: 30: 00.000Z"
                },
                "customConfig": {
                    "customField1": "value1",
                    "customField2": true
                },
                "summary": {
                    "name": "DESKTOP-ABC123",
                    "devId": "string",
                    "osVersion": "10.0.19045.3803",
                    "osVersionName": "Windows 11 Pro",
                    "os": "Windows",
                    "serialNumber": "SN123456789",
                    "imei": "356938035643809",
                    "battery": "85%",
                    "expirationTimestamp": "2027-02-10T00: 00: 00.000Z",
                    "supervised": true,
                    "image": "https://cdn.example.com/device-surface-laptop.png",
                    "compliance": {
                        "compliant": true,
                        "lastCheck": "2026-02-10T12: 00: 00.000Z"
                    },
                    "manufacturer": "string",
                    "model": "string",
                    "udid": "string",
                    "hostname": "string",
                    "ipAddress": "string",
                    "macAddress": "string"
                },
                "scripts": [
                    {
                        "id": "507f1f77bcf86cd799439077",
                        "type": "once",
                        "loopTime": 60,
                        "resetDate": "2026-02-10T00: 00: 00.000Z",
                        "arguments": "-ExecutionPolicy Bypass -Parameter1 Value1",
                        "argumentsProcessed": "-ExecutionPolicy Bypass -Parameter1 ProcessedValue",
                        "name": "System Configuration Script",
                        "description": "Configures network settings and security policies",
                        "runner": "powershell.exe",
                        "scope": "user"
                    }
                ],
                "scriptsInfo": [
                    {}
                ],
                "lastStatusReportTime": "2026-02-10T12: 30: 00.000Z",
                "type": "windows",
                "winPolicy": {
                    "id": "507f1f77bcf86cd799439011",
                    "organizationId": "507f1f77bcf86cd799439022",
                    "winEnterpriseId": "507f1f77bcf86cd799439033",
                    "name": "Corporate Security Baseline",
                    "config": {
                        "./Device/Vendor/MSFT/Policy/Config/Security/RequireDeviceEncryption": {
                            "format": "int",
                            "value": "1",
                            "priority": 100
                        }
                    },
                    "applications": [
                        {
                            "winApplicationId": "507f1f77bcf86cd799439044",
                            "configuration": {
                                "language": "en",
                                "edition": "enterprise"
                            },
                            "action": "available",
                            "updatePolicy": {
                                "autoUpdate": true,
                                "allowedVersions": ">=1.0.0"
                            }
                        }
                    ],
                    "applicationsInfo": [
                        {}
                    ],
                    "bookmarks": [
                        {
                            "title": "string",
                            "description": "string",
                            "url": "string",
                            "iconBase64": "string",
                            "iconUrl": "string"
                        }
                    ],
                    "scripts": [
                        {
                            "id": "string",
                            "type": "once",
                            "loopTime": 0,
                            "resetDate": "2024-01-01T00: 00:00Z",
                            "arguments": "string",
                            "argumentsProcessed": "string",
                            "name": "string",
                            "description": "string",
                            "runner": "string",
                            "scope": "user"
                        }
                    ],
                    "scriptsInfo": [
                        {}
                    ],
                    "admxConfigs": [
                        {
                            "winAdmxConfigId": "507f1f77bcf86cd799439055"
                        }
                    ],
                    "admxConfigsInfo": [
                        {
                            "id": "507f1f77bcf86cd799439055",
                            "appName": "Microsoft Edge",
                            "settingType": "Privacy",
                            "fileName": "edge.admx",
                            "description": "Controls Edge browser privacy settings"
                        }
                    ],
                    "agentConfiguration": {
                        "enabled": true,
                        "buildTag": "v2.5.0",
                        "allowLocation": true,
                        "allowNetworkStatus": true,
                        "allowPackageTime": false,
                        "allowPackageTransfer": false,
                        "policyFeatures": {
                            "defaultViewFeature": "applications",
                            "toggledFeatures": [
                                {
                                    "name": "applications",
                                    "active": true
                                }
                            ],
                            "enableDefaultView": true
                        }
                    },
                    "assets": [
                        {
                            "mdmAssetId": "string",
                            "location": "string",
                            "assetName": "string",
                            "scope": "user"
                        }
                    ],
                    "assetsInfo": [
                        {}
                    ],
                    "version": 5,
                    "segmentId": "1",
                    "exposeToChildren": true,
                    "updatedAt": "2026-02-10T14: 30: 00.000Z",
                    "createdAt": "2025-10-15T09: 00: 00.000Z"
                },
                "deviceWinPolicy": {
                    "id": "507f1f77bcf86cd799439011",
                    "organizationId": "507f1f77bcf86cd799439022",
                    "winEnterpriseId": "507f1f77bcf86cd799439033",
                    "name": "Corporate Security Baseline",
                    "config": {
                        "./Device/Vendor/MSFT/Policy/Config/Security/RequireDeviceEncryption": {
                            "format": "int",
                            "value": "1",
                            "priority": 100
                        }
                    },
                    "applications": [
                        {
                            "winApplicationId": "507f1f77bcf86cd799439044",
                            "configuration": {
                                "language": "en",
                                "edition": "enterprise"
                            },
                            "action": "available",
                            "updatePolicy": {
                                "autoUpdate": true,
                                "allowedVersions": ">=1.0.0"
                            }
                        }
                    ],
                    "applicationsInfo": [
                        {}
                    ],
                    "bookmarks": [
                        {
                            "title": "string",
                            "description": "string",
                            "url": "string",
                            "iconBase64": "string",
                            "iconUrl": "string"
                        }
                    ],
                    "scripts": [
                        {
                            "id": "string",
                            "type": "once",
                            "loopTime": 0,
                            "resetDate": "2024-01-01T00: 00:00Z",
                            "arguments": "string",
                            "argumentsProcessed": "string",
                            "name": "string",
                            "description": "string",
                            "runner": "string",
                            "scope": "user"
                        }
                    ],
                    "scriptsInfo": [
                        {}
                    ],
                    "admxConfigs": [
                        {
                            "winAdmxConfigId": "507f1f77bcf86cd799439055"
                        }
                    ],
                    "admxConfigsInfo": [
                        {
                            "id": "507f1f77bcf86cd799439055",
                            "appName": "Microsoft Edge",
                            "settingType": "Privacy",
                            "fileName": "edge.admx",
                            "description": "Controls Edge browser privacy settings"
                        }
                    ],
                    "agentConfiguration": {
                        "enabled": true,
                        "buildTag": "v2.5.0",
                        "allowLocation": true,
                        "allowNetworkStatus": true,
                        "allowPackageTime": false,
                        "allowPackageTransfer": false,
                        "policyFeatures": {
                            "defaultViewFeature": "applications",
                            "toggledFeatures": [
                                {
                                    "name": "applications",
                                    "active": true
                                }
                            ],
                            "enableDefaultView": true
                        }
                    },
                    "assets": [
                        {
                            "mdmAssetId": "string",
                            "location": "string",
                            "assetName": "string",
                            "scope": "user"
                        }
                    ],
                    "assetsInfo": [
                        {}
                    ],
                    "version": 5,
                    "segmentId": "1",
                    "exposeToChildren": true,
                    "updatedAt": "2026-02-10T14: 30: 00.000Z",
                    "createdAt": "2025-10-15T09: 00: 00.000Z"
                },
                "winPolicyAssignments": [
                    {
                        "winPolicyId": "698f42e5457fafa13d0887a3",
                        "winPolicy": {},
                        "priority": 1
                    }
                ],
                "winPolicyAssignmentsEnforced": [
                    {
                        "winPolicyId": "698f42e5457fafa13d0887a3",
                        "winPolicy": {},
                        "priority": 1,
                        "automationRule": {
                            "id": "698f42e5457fafa13d08879d",
                            "name": "Sales Team iOS Policies",
                            "deviceAudiences": [
                                {
                                    "id": "698f42e5457fafa13d0887a7",
                                    "name": "Sales Department",
                                    "reasons": [
                                        "tag:sales",
                                        "user.department:Sales"
                                    ]
                                }
                            ]
                        }
                    }
                ],
                "subType": "device",
                "stateHistory": [
                    {
                        "state": "ACTIVE",
                        "date": "2025-10-15T09: 15: 00.000Z",
                        "config": {
                            "reason": "initial-enrollment"
                        }
                    }
                ],
                "lastLocation": {
                    "agent": {
                        "origin": "agent",
                        "date": "2026-02-10T12: 00: 00.000Z",
                        "latitude": 40.7128,
                        "longitude": -74.006,
                        "ip": "203.0.113.45",
                        "lastReportDate": "2026-02-10T12: 00: 00.000Z",
                        "address": {
                            "address": "123 Main Street",
                            "number": "123",
                            "postalCode": "10001",
                            "city": "New York",
                            "country": "United States"
                        }
                    },
                    "ip": {
                        "origin": "agent",
                        "date": "2024-01-01T00: 00:00Z",
                        "latitude": 0,
                        "longitude": 0,
                        "ip": "string",
                        "lastReportDate": "2024-01-01T00: 00:00Z",
                        "address": {
                            "address": "string",
                            "number": "string",
                            "postalCode": "string",
                            "city": "string",
                            "country": "string"
                        }
                    }
                },
                "refreshInfoNeeded": [
                    "hardware",
                    "applications"
                ],
                "enrolledDate": "2025-10-15T09: 15: 00.000Z",
                "smartAttributeAssignments": [
                    {
                        "smartAttributeId": "string",
                        "smartAttribute": {
                            "id": "string",
                            "organizationId": "string",
                            "segmentId": 0,
                            "exposeToChildren": true,
                            "name": "string",
                            "description": "string",
                            "output": {
                                "type": "string"
                            },
                            "input": {
                                "type": "constant",
                                "value": {
                                    "admDevice": {
                                        "value": "string"
                                    },
                                    "aosDevice": {
                                        "value": "string"
                                    },
                                    "emmDevice": {
                                        "value": "string"
                                    },
                                    "winDevice": {
                                        "value": "string"
                                    }
                                },
                                "source": "constant"
                            },
                            "counts": {
                                "android": {
                                    "smartAttributeAssignments": 0,
                                    "smartAttributeAssignmentsEnforced": 0
                                },
                                "apple": {
                                    "smartAttributeAssignments": 0,
                                    "smartAttributeAssignmentsEnforced": 0
                                },
                                "windows": {
                                    "smartAttributeAssignments": 0,
                                    "smartAttributeAssignmentsEnforced": 0
                                }
                            }
                        }
                    }
                ],
                "smartAttributeAssignmentsEnforced": [
                    {
                        "smartAttributeId": "string",
                        "smartAttribute": {
                            "id": "string",
                            "organizationId": "string",
                            "segmentId": 0,
                            "exposeToChildren": true,
                            "name": "string",
                            "description": "string",
                            "output": {
                                "type": "string"
                            },
                            "input": {
                                "type": "constant",
                                "value": {
                                    "admDevice": {
                                        "value": "string"
                                    },
                                    "aosDevice": {
                                        "value": "string"
                                    },
                                    "emmDevice": {
                                        "value": "string"
                                    },
                                    "winDevice": {
                                        "value": "string"
                                    }
                                },
                                "source": "constant"
                            },
                            "counts": {
                                "android": {
                                    "smartAttributeAssignments": 0,
                                    "smartAttributeAssignmentsEnforced": 0
                                },
                                "apple": {
                                    "smartAttributeAssignments": 0,
                                    "smartAttributeAssignmentsEnforced": 0
                                },
                                "windows": {
                                    "smartAttributeAssignments": 0,
                                    "smartAttributeAssignmentsEnforced": 0
                                }
                            }
                        }
                    }
                ],
                "smartAttributes": [
                    {
                        "id": "string",
                        "type": "constant",
                        "label": "string",
                        "value": "string",
                        "updatedAt": "2024-01-01T00: 00:00Z"
                    }
                ],
                "segmentId": 0,
                "createdAt": "2025-10-15T09: 00: 00.000Z",
                "updatedAt": "2026-02-10T14: 30: 00.000Z"
            }
        ],
        "totalDocs": 0,
        "limit": 0,
        "hasPrevPage": true,
        "hasNextPage": true,
        "page": 0,
        "totalPages": 0,
        "prevPage": 0,
        "nextPage": 0,
        "lean": true
    }
}

401 Response application/json

status boolean optional

false

error object optional

code number optional

4001

message string optional

Unauthorized

{
    "status": false,
    "error": {
        "code": 4002,
        "message": "No auth token"
    }
}

404 Response application/json

status boolean optional

false

error object optional

code number optional

3001

message string optional

Entity not found

{
    "status": false,
    "error": {
        "code": 3001,
        "message": "Entity not found"
    }
}

Request

Authorization

Path Params1

Query Params8

Responses